home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmTabListInsertTabs.z / XmTabListInsertTabs
Text File  |  1998-10-30  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttIIIInnnnsssseeeerrrrttttTTTTaaaabbbbssss((((3333XXXX))))   UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV   XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttIIIInnnnsssseeeerrrrttttTTTTaaaabbbbssss((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttIIIInnnnsssseeeerrrrttttTTTTaaaabbbbssss - A convenience function that inserts
  10.           tabs into a tab list
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttIIIInnnnsssseeeerrrrttttTTTTaaaabbbbssss(
  15.           XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt oooollllddddlllliiiisssstttt,
  16.           XXXXmmmmTTTTaaaabbbb ****ttttaaaabbbbssss,
  17.           CCCCaaaarrrrddddiiiinnnnaaaallll ttttaaaabbbb____ccccoooouuuunnnntttt,
  18.           iiiinnnntttt ppppoooossssiiiittttiiiioooonnnn);
  19.  
  20.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  21.           This page documents Motif 2.1.
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.           XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttIIIInnnnsssseeeerrrrttttTTTTaaaabbbbssss creates a new tab list that includes the
  25.           tabs in _o_l_d_l_i_s_t. This function copies specified tabs to the
  26.           tab list at the given position. The first _t_a_b__c_o_u_n_t tabs of
  27.           the _t_a_b_s array are added to the tab list. If _o_l_d_l_i_s_t is
  28.           NULL, XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttIIIInnnnsssseeeerrrrttttTTTTaaaabbbbssss creates a new tab list containing
  29.           only the tabs specified.
  30.  
  31.           _o_l_d_l_i_s_t   Specifies the tab list to add the tabs to.  The
  32.                     function deallocates _o_l_d_l_i_s_t after extracting the
  33.                     required information.
  34.  
  35.           _t_a_b_s      Specifies a pointer to the tabs to be added to the
  36.                     tab list.  It is the caller's responsibility to
  37.                     free the tabs in _t_a_b_s by using XXXXmmmmTTTTaaaabbbbFFFFrrrreeeeeeee.
  38.  
  39.           _t_a_b__c_o_u_n_t Specifies the number of tabs in _t_a_b_s.
  40.  
  41.           _p_o_s_i_t_i_o_n  Specifies the position of the first new tab in the
  42.                     tab list. A value of 0 (zero) makes the first new
  43.                     tab the first tab in the tab list, a value of 1
  44.                     makes it the second tab, and so on. If _p_o_s_i_t_i_o_n is
  45.                     greater than the number of tabs in _o_l_d_l_i_s_t, then
  46.                     the tabs will be inserted at the end. If _p_o_s_i_t_i_o_n
  47.                     is negative, the count will be backwards from the
  48.                     end. A value of -1 makes the first new tab the
  49.                     last tab, and so on.
  50.  
  51.      RRRREEEETTTTUUUURRRRNNNN
  52.           If _t_a_b_s is NULL or _t_a_b__c_o_u_n_t is 0 (zero), this function
  53.           returns _o_l_d_l_i_s_t. Otherwise, it returns a new tab list.  The
  54.           function allocates space to hold the returned tab list.  The
  55.           application is responsible for managing the allocated space.
  56.           The application can recover the allocated space by calling
  57.           XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttFFFFrrrreeeeeeee.
  58.  
  59.      RRRREEEELLLLAAAATTTTEEEEDDDD
  60.  
  61.  
  62.  
  63.      PPPPaaaaggggeeee 1111                                         ((((pppprrrriiiinnnntttteeeedddd 11110000////22224444////99998888))))
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttIIIInnnnsssseeeerrrrttttTTTTaaaabbbbssss((((3333XXXX))))   UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV   XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttIIIInnnnsssseeeerrrrttttTTTTaaaabbbbssss((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt(3) and XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttFFFFrrrreeeeeeee(3).
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.